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Introduction 


Introduction 


Welcome to the Rainbow i OS Release Notes! 

This document describes the changes made in Rainbow 70S. previously known as TOS 
1.4, the latest version of the operating system for Atari ST and Mega computers. They also 
contain a good deal of supplemental documentation tor Rainbow TOS <?/7c / previous versions 
of i OS. 


I here is a chapter for each layer of TOS (Desktop, AES. and sc on). There is at least one 
section in each chapter for "Changes," and usually a section for "Supplemental 
Documentation." Seme chapters have other sections, like "Forcing 'Media Change'." 

Within each of these sections, entries deal with individual issues, iike "Autorun 
Applications." or "Malice." Each point within an entry is preceded by a dash (-). There are 
"iso occasional references to other sections or entries, for more detailed information. 

It is suggested you look through the Table of Contents, then read through the document in 
the order of vour interests. 


Please be sure to read the "Addendum" chapter! i his describes problems found in 
Rainbow i OS after its release, ana what can be done about them. 


And as always, we welcome your comments about this document. 


Enjoy. 
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Desktop Changes 


Desktop Changes 


Aborting Operations: 

" CoDy, Delete, and Move operations can be interrupted with <Undo>; holding 
down <Undo> results in a dialog asking if the user wishes to abort. (This does 
not apply to Disk Copy or Format.) 

Application Crash: 

- When recovering from an application crash, wi nd_update(FALSE) is executed 
before going into the main event_multi that waits for user interaction. This is 
handled by the new wi nd_rtew function. (See "AES Supplemental 
Documentation.") 

Autorun Applications: 

- GEM programs can be auiorun from disk. This is set up through the "install 
Application" dialog, where the user can select "Auto" (boot) staius. then "Save 
Desktop." The autoboot application can also be uninstalled from this dialog. The 
autoboot application can be either a "PRG" or a "TOS", but not a "TTP" (TOS 
Takes Parameters.) 

- Selecting a new Autorun Application wili replace the previous one. 

Copy, Deieie. Move: 

- The Copy. Delete, and Move dialog box shows destination folder and tile name as 
the operation progresses. The file name is displayed immediately in the box as 
the operation begins. 

Desk Accessories: 

- Desk Accessories can write any VtN_SELECTED message to the Desktop. 

DESKTOF.iNF: 

- The DESKTOP. INF tile remains compatible across ail existing versions of TOS. 

- A warning message appears if there is insufficient space to save DESKTOF.INF. 

_ isktop Info,,.: 

- The Desktop's copyright notice now lists "1985. 86. 87. 88. 89". 1988 and 1989 
were added. 

- Another cosmetic change can be observed in the "About Desktop..." box when it 
is shown in color. 

Dialog Boxes: 

- Many dialogs are more concise. This includes error dialogs like the one about 
"Your output device is not receiving data..." and others. 

- Leading underscores in numeric fields of boxes have been replaced by spaces. 
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Desktop Changes 


Disk Copy: 

- Singie-drive aisk copies now require as lev/ disk swaps as possible: all available 
memory is used as a copy buffer. 

- When copying disks between drives A: and B:, with no disk in source or 
destination, an error occurs. "Cancel'' now returns the user to the Disk Copy 
Dialog. 

Disk Copy/Format: 

- Disk Copy and Disk Format have been combined into one dialog box. Whichever 
operation was chosen from the Desktop is the default in the box when it appears. 
For example, if disk A: is dragged to disk 3:. the Copy/Format box appears with 
"Codv" selected. Bv clicking the "Format" button, the user can choose to format a 
disk. 

- if users click Format from Copy, or vice versa, reasonable defaults appear for the 
newly selected operation. 

Ts'isk Directories: 

- if you try to get a directory of a drive without a disk. ’Cancel’ now aborts the 
operation and returns you to the Desktop. 

- Pressing <Esc> forces the Desktop to read the directory of the topped window. 
Before. it would only do so if a media change had been detected. 

- The Desktop now re-reads ail open directories (instead of only those of drives A: 
and 3:) after an operation which couid change the directory iniormation. 

Disk Format: 

■ The 'Format Disk" diaioa now defaults to "Exit" if <Re;urn> is pressec. i his is 
consistent with other parts oi the Desktop. 

- The Desktop now formats disks with an MS-DOS compatible boot sector. 

- Double-sided disks are now "twisted" in a more-efficient way than before. Singie- 
sided disks are alreaay "twisted" optimally, and have been since Mega F.CMs. 

Disk Open: 

- If an error occurs when a drive is opened', a blank window no longer results. 

Tile Copy: 

- When files are copied, the pointer now changes to a "busy bee" even if the 
Desktop is set to copy without confirmation. 

- When copying files and an error occurs, the arrow now becomes a busy bee 
when Retry is clicked. 

- Files dragged to the border of a window 'whose first folder is not displayed are 
copied to the curreni directory of that window. Previously, the files wouJd be 

, copied into the folder. 

Files: 

• 

- Files which are both hidden andsyz\em or read-only will no longer show up on 
the Desktop (or in the File Selector). 


Page 10 


RAINBOW TOS RELEASE NOTES -AUGUST 7, 1989 


Desktop Changes 


File Move; - A Iile can be "moved" as well as copied. To do this, select the files, hold down 

<Controi>, and drag She files to the destination. <Control> is checked when the 
mouse button is released, so users can change their mind between Copy and 
Move mia-arag (especially useful ii a number of files have been painstakingly 
selected). When the mouse button is released, a "Move Fiie(s)" box appears. 


Filenames: 


- i he Desktop no longer ailows users to enter illegal characters (like *.?. or :) in 
filenames. 


Folders: - if ine user attempts to copy a tile into a folder containing a folder with the same 

name as the file being copied, the Desktop displays an "Invalia Copy Operation" 
aiert box. Formerly, it would show 3 "Disk Fu/r error. 

- "Show Info..." now ailows a folder to be renamed, jus! as it does files. 

- The Desktop no ionger ailows users to enter illegal characters (like *.?. or :) in 
folder names. 


Installed Applications: - "Install Application" has a "Remove" button, ana "Install" is new the default. This 

ciaiog is also used to choose Normai or Auiorun status. (See "Autorun 
Applications") 

- The default directory of an installed appiication is always set to the directory of 
the document that invoked it. even if the document is opened from a background 
window. 

- Only the ”fi 1 ename. ext" is passed to the installed application on its command 
line. This fixed programs that oniy expected 14 characters of command line. 

■ rsrc_load no ienger uses the she!_read/wn' te butter as temporary storage, 
so the full pathname oi a Desktop-iaunched application is aiways available in the 
snel _read/wri te cutter. 

■ shel_fi nb now looks first in the directory incicated in the shel_read/wri te 
buffer (the directory from which an acpiication was launched), then in the current 
cirectory. then down the environment search path. Installed applications can be 
anywhere, and stiil find their resources. 


Install Disk Drive: - "install Disk Drive" has "Install" as its default. 


Name Conflicts: - Upon a "Name Conilic!" during a Copy or Move operation, the user has three 

choices: Copy goes ahead and copies the file (overwriting the one on the 
destination), Skip does nothing with thai particular file but continues the copy 
operation, and Guit aborts the entire copy operation. 

- "Set Preferences" determines if the system confirms name conflicts. If 
"Confirmation required for: File Overwrites" is set to "No", files will be overwritten 
without warning. If a folder name conflict occurs, a dialog appears regardless. 

- Choosing "Skip" on a folder name conflict skips the entire folder: choosing "Copy" 
begins copying iiies into the target folder that caused the name conflict. 
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Desktop Changes 


Print l ext File: - me keyboard is checked every 16 characters: a. C. ‘C and <Unco> ail cause 

printing to abort. 


Running Applications: - Applications can be run from background windows: wnen the Desktop launches 

an application, it snel_wri tes the full pathname oi ‘he application. 


Selecting Fiies: - if the <Shiit> key is netd down while selecting tiles, sticking anywhere within the 

window does not deselect any selected files. Clicking :l'!s;cs the window or 
clicking anywnere 'with <Shiit> released will deseiee: ail the selected iiles. 

- Bv popular demand, selecting files in inactive winccws by hoicing down the right 
mouse button now works and is supocrted. 


Show Info...: - "Snow Info..." for tiles or folders now uses the same ciatcg. ihe name field ailows 

the fiie or folder to be renamed, but file aitribuies are cnty active for files. 

- The date separator in "Show File Inio"" ancl "Show Fcicer Info" is now Before, 
they were inconsistent, one using 7” ana the other 

- ""Bytes Available" and "Bytes Used" fields have been expanded to accommodate 
vaiues up to 2147^-83647 (Hex 7FFFFFFF). 


Show T exi Fiie: 


- Hitting <space> in the middle oi a page makes the -Vi 
line being displayed when ihe key is hit. rather than h 
waiting tor the -More* and then hitting <space>. 


;re- come 24 lines from the 
vine ths same effect as 


- d. D ana *0 cause the -More- to come 1/2 page from the line being displayed 
when the key is hit: <F.elurn> makes it come one line from the line being 
displayed when the key is hit. 

- q. G. ‘C. and <Undo> cause the output to stop immediately. 

■ Line Wrap is not mcdiiied: if the V7-32 Emulator is in no-wrap mode, that's what 
you get. 

- If a "Drive Not Responding" alert box is displayed when ihe Desktop "Shows'" a 
fiie. a message is printed to the screen: "Ccul a net fi nd fi 1 ename . axt". 
Pressing any key returns to the Desktop. 


Time/Date Stamp: _ the iime/Date Stamp on files is now preserved across Copies and Moves. 


Windows: - The desktop now opens the next window where the last window was closed. 

■ Desktop shows as many files as possible inside eacn directory window. The only 
limit is the amount of free memory in the system: this removes the old static file 
allocation limit of 400. 

- All background windows are updated after a file copy, move, delete, disk copy, or 
disk format operation. 
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AES Changes 

appl_initf): 

- "appl _i ni t Q " call returns a version number or 0x01 ^0 in gl obal [0] . 

AutobGot Appiicaiian: 

- When running an auioboot application, the AES changes to its directory. 

■ When an autODOot application is active. AES gives accessories the same number 
of dispatch calls to initialize as they would have if the Desktop were starting ud. 

Context Switches: 

- No context switches are allowed curing the AES Critical Error Handler, correcting 
a oug where some media errors would cause the File Selector to crash at the 
next critical error. (See "Fiie Selector.") 

default Path: 

■ The Deiault Path when an application starts is not changed by she1_vvri te. nor 
is it set when the AES shell runs an application. From the Desktop, the user 
seiects the "current path" by determining which window is topped when an 
application is launched. The right mouse button can be used to set a different 
default path. The behavior for insiailed documents may chance in future versions 
of TCS: use shel_fi nd to find tiles. 

Applications which use she! jvrt ze to chain to another program are responsible 
for setting the default path for the program. 

evnt_muiti and 
evnt_timer: 

■ evnr_timer (or evni_mul ti with a timer) no longer cause Desk Accessories 
to sleep forever. 
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AES Changes 


- An application can now send a "title" string to the File Selector. See 
documentation for "f sel_exi nputQ . " 

r: provides 16 drive label buttons tor easier drive selection. 

FS now handles <RETURN> differently on text editing: after editing a pathname 
pressing <RE i URN> enters the path and redisplays the FS. After editing a 
filename, the F5 exits. 

If the user passes in a path with a leading backslash, this path is appended to the 
default directory of the default drive internally, and files from the resulting 
directory are displayed. 

i he static file allocation of 100 per FS has been removed. The AES will 
Mai 1 OC Q memory for directories with large numbers of files. If availaole 
memory ;s insufficient. ~se1_i nputQ will exit with an error code. 

- FS now handles long pathnames. 

ra now handles multiple "abort/continue" errors correctly. 

- i-S preserves current DTA buffer addresses, ciio rectancies. and default 
directories. 

H a diskette is removed when the file selector is called, the system now handles 
Cancel on the resulting error dialog correctly. 

' how handles colons in filenames, even thouoh the colon is NOT a le^al 
filename character. ~ 3 

- FS no longer displays files that have the hidden flag set. 

Sequence of the file selector redraw has been imorcved to be more vi«ual!v 
acpealing. 

- Clicking anywhere in the file display window reloads a cirectory without -fleeting 
the filename template in the PATH line. 

- Media errors no longer cause the FS to crash at the next critical error. (See 
"Contexi Switches") 

- New bindings are available for the FS. 


form dial: 


i orm_cri al now only forces the too window So be redrawn if it tails inside the 
rectangle of the fcrm_di al . 


Menu Bar: 


i oggling between i rue. and False on the Menu Sar no lonoer corruots the 
semaphore. 

The Menu Bar line is now redrawn in REPLACE mode, rather than XOR mode: 
this prevents the AES from "undrawing" a menu bar line already drawn by an 
application. 


Menus: 


AES now reserves 1/4 of the current screen memory (rather than 1/4 of 32000 
bytes) as a menu dropdown buffer, allowing applications to take advantage of 
large monitors with larger menus than possible on smaller screens. 


Mouse Clicks: 


Mouse single click response has been improved for applications which don't 
request double clicks. Now, applications which use only single click event 
reporting will feel more responsive. 
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AES Changes 


Mouse Cursor. AES no longer accidentally restores a previously saved mouse state in favor of 

the state set with graf_mouse. This behavior sometimes caused the cursor to 
remain a busy bee even after an application had set it to an arrow, or to leave 
"trails" in the menu bar. 


0bjc_center. objc_ce.nter was changed so a form’s X coordinate is no longer character 

aligned: odd-sized forms will no longer appear off center when objc_center is 
used to get centered coordinates. 


rsrc load: 


rsrc_load no longer uses the shel_read/wn' te buffer as temporary storage, 
so the full pathname of a Desktop-launched application is always available in the 
shel_read/write buffer. 


S'hel_envrnO. - shel_envrn() now uses the actual environment string to search for 

environment variables, rather than using its own fixed copy: environments, 
including the PA i H= string AES uses to find resource files, can be set up in the 
AU i O folder and used by all applications thereafter. This can't be accomplished 
sftsr the AUTO folder, because AES has an internal pointer to its environment 
string, and its iGcatiGn cannot be fixed (or. as a result, documented). 
shci_envrnQ is still compatible with the old style ?AT;-;=0A:\0Q0. 

Path name separators can now be commas or semicolons: previously, semicolons 
were required. 


She i _ri nd now looks iirsi in the directory inGicaied in the she! _read/wri te 
buffer < the directory from which an appiicaticn was launched), then in the current 


directory, then down the environment search path. Installed applications can be 
anywhere, and stiil find their resources. 


si aeiO and 


iai documentation is now available for she1_get() and shel_putC 
n were originally implemented for use by the Control Panel. 


d nd_getQ call with field parameter ol »VF_SCREEN is now supported. 


Windows: 


When the user clicks in the scroll area oi a window. AES waits a double click time 


before starting the scroll repeat. Single clicks only cause one message to be 
sent. 
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AES Supplements/ Documentation 


AES Supplemental Documentation 

The following section contains documentation supplemental to the existing Aci manual, and 
clarifications of existing documentation. 


Supplement to: 6.4 - Object Library Routines 


ob_ednewi dx - not used. 

ob_edtree - the address oi the object tree containing the object with the text to be 
edited. 


ob_edreturn = obic_edit(ob_edtree, ob_edobject, ob_edchar, ob_edidx, ob_edki nd) ; 


Supplement to: 6.3.2 - TEDINFO Structure 


te_pval id - Pointer to a text string containing characters that validate any entered text. 

F - Allow ail vaiid DOS tiiename characters, plus Question Mark (?). 

Asterisk {*>. and Coion (:). 
f - Allow oniy valid DOS filename characters. 

ob_edreturn = objc_edi t(ob_edtree , ob_edobject, ob_eachar, ob_eaidx, ob_edkina); 
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AES Supplements / Documentation 


Supplement to: 7.3.3 - FORM_ALERT 


Purpose: Display an alert. (Section 7.2 describes the complete sequence of calls internal to 

FORM_ALERT) 


Parameters: control (0) = 52 

control (1) = 1 

control (2) = 1 
control (3) = 1 

control (-0 = 0 

int_in(0) = fo_adefbttn 

int_out(0) = fo_aexbttn 

addr_in(0) = i fo_astring 


fo_adefbttn - ihe form's DEFAULT exit button (see section 7. 1.3.1): 

0 - no GEFAULT exit button 

1 - first exit button 

2 - second exit button 

3 - third exit button 

fo_aexbttn - a number identifying the exit button selected by the user: 

1 - first exit button in string 

2 - second exit button in string 

3 - third exit button in string 


fo_asiri ng - the acGress of the string containing the aieri (see section 7.1). 

* Each aiert line must be less than 30 characters. 

* Each button must be less than 10 characters. 


mple call to C language binding: 

* 

fo_aexbttn = form_al ert(fo_adefbtrn , fo_astri ng) ; 
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AES S upp/ementaf Documentation 


Supplement to: 7.3.4 - FORM_ERROR 


Purpose: 


Display an error box. 


Parameters: control (0) = 53 

control (1) = 1' 
control (2) = 1 

control (3) = 0 

control (4) = 0 


i nt_i n(Q) 
int_out(0) 


fo_enum 

fo_eexbttn 


fo_enum - the GEMDOS error codes in MS-DOS format (from 1 onwards). 

fo_eexbttn - ,a code identifying the user's exit button selection. 

1 - first exit button in string 

2 - second exit button in string 

3 - third exit button in string 


Sample call to C language binding: 

fo_eexbttn = form_error(fo_enum) ; 


Error messages: 

fo_enum 2,3,18 
fo_enum 4 

fo_enum 5 

fo_enurn 8,10,11 
fo_enum 15 


i his application cannot find the folder or iiie you just tried to access. 

This application does not have room to open another document. To make room, 
dose any document that you do not need. 

An item wiih this name already exists in the directory, or this item is set to 
Read-only status. 

Thefe is not enough memory for the application you just tried to run. 

The drive you specified does not exist. 
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AES Supplemental Documentation 


Supplement to: 13.3.2 - SHEL_WRITE 


Purpose: Tells GEM AES whether to run another application and. if so. which application to run. 

Parameters: control (0) = 121 

control (1) = 3 

control (2) = 1 

control (3) = 2 
control (4) = 0 

int_in(0) = sh_wGoex 
int_in(l) = sh_wisgr 
int_in(2) = sh_wiscr 

int_out(0) = sn_wreturn 

addr_in(0) = sh_wpcmd 
addr_in(l) = sh_wptail 


Description: sh_wdoex - a coded instruction to exit the system or run another application when the 

user exits the current application. 

0 ■ exit and return to GEM DESKTOP 

1 - run another application 


sh_wi sar - a code for whether the next application is a graphic application. 

0 - not a graphic application 

1 - graphic apclication 


sh_wi scr - currently ignored by the AES: should be set to zero. 


sh_wreturn - a-coded return message 
0 - an error exists 
n - no error exists 


sh_wpcmd - the address of the new command file to execute 

ah_wptai 1 - the address of the command tail for the next program. Note: The first byte 

of the command tail buffer contains the length (in bytes) of the command 
fail. The actual command tail begins at the second byte of the buffer. The 
string need not be null-terminated. 

Sample call to C language binding: 

sh_wreturn = shel_wn’ te(sh_wdoex , sh_wisgr, sh_wiscr, sh_wpcmd, sh_wptail); 
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AES Supplemental Documentation 


Supplement to: 13.3.5 - SHEL_GET 

Purpose: Let the application read data from the AES’s shell internal buffer. (The length of the ’get data' 

buffer must be at least 4192 bytes.) 

Parameters: control (0) = 122 

control (1) = 1 
control (2) = 1 
control (3) = 1 

control (4) = 0 

int_in(0) = sh_glen 

addr_in(0) = sh_gbuff 

int_out(0) = sh_greturn 


sh_greturn - a coded return message 
0 - an error exists 
n (positive integer) - no error exists 

sh_gl en - the length of the buffer. 

sh_gbuff - !he address of the buffer. 

Sample call to C language binding: 

sh_greturn = shel_get(sh_gbuff , sh_glen); 
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AES Supp/ementa / Documentation 


Supplement to: 13.3.6 - SHEL_PUT 

Purpose: Let the application save data into the AES's shell internal buffer. 

Note: Currently, the AES Desktop uses this buffer to store the DESKTOP . INF data. Any usage of 

this buffer may corrupt the data already stored there. Also, the length of the data that goes into 
the buffer must not be more than 1024 bytes for 1 1/20/85 TOS ano 4/22/87 TOS, and no more 
than 4192 bytes for Rainbow i CS. 


Parameters: control (0) = 123 

control (1) = 1 
control (2) = 1 
control (3) = 1 

control (4) = 0 

int_in(0) = sh_plen 

it 

addr_in(0) = sh_pbuff 
int_out(0) = sh_prsturn 


sh_preturn - 

a coded return message 
0 - an error exists 
n (positive integer) - no error 

sh_plen 

the length or the buffer. 

sh_pbuff 

the address or the buffer. 


Sample call to C language bincing: 

sh_preturn = shel_put(sh_pbuff , sh_plen); 
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AES Supplemental Documentation 


Calling AEbl - Care mus; be used when calling AES from the 68000's supervisor mode. Some 

AtS functions return to the caller in user mode, and all AES functions use the 
53000 register usp to save the caller's registers. This means that you can not call 
AES when .you are in supervisor moce as a result of the Super(OL) GE.V1DOS 
call, because your user stack and supervisor stack overlap. 

Also, when calling Super with an argument other than 0L. be careful to leave a 
little room above (that is. at higher-numbered addresses) the initial stack pointer 
you provide as the argument lo Super. For instance, this is a fragment using 
Super correctly: 


mvfnO 

{ 

char nystackf 8192] ; 
long oiassp: 

geo super mode, sec ssp near top of mvstack 
oldssp = Super(o,nystack[8180]) : 

/'“ ... stufr done in supervises' race ... 

get back to user mode •'•/ 

Super(ol c'ssp) : 
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New AES Calls 


New AES Cails 


There are two new AES calls. FSEI — EXINPU i and WIND_NEW. They are documented below. 


10.3.2 FSEL_EX INPUT 

Purpose: This function has the same functionality as the FSEL_INPUT call except that it accepts an 

additional input parameter called fs_label to display a string on the top of the file selector 
box. This null-terminated string should be no more than 30 characters long; it will replace the 
original 'File Selector’ string. This feature allows the program to indicate what will be done with 
the file the user selects. 


Parameters: control (0) = 91 

control (1) = 0 
control (2) = 2 
control (3) = 3 
control (4) = ‘0 


int_out(0) = fs_i return 
int_out(l) = fs_i exbutton 


addr_in(0) 
accir_i n (1) 
addr_i n(2) 


fs_i i npath 
fs_i nnsel 
fs_l abel 


ts_i return - A coded return message. 

0 - an error exists 

n (positive integer) - no error exists 


rs_i exbutton - A code identifying the exii button selected by the user. 

0 - Cancel 

1 - OK 


fs_i i npath 


fs_i nnsel 


fs_l abel 


The address oi the buffer that holds the initial directory specification 
displayed in the File Selector oiaiog box. This buffer also holds ihe 
directory specification in the File Selector dialog box when the user 
selected OK or Cancel. 

The address of the buffer that holds the initial selection displayed in the 
File Selector dialog box. This buffer also holds the selection in the File 
Selector dialog box when the user selected OK or Cancel. 

The address ol the string that will be displayed at the top of the File 
Selector box. 


Sample call to C language binding: 

fs_i return »= fsel_exinput(fs_innpath, fs_innsel t &fs_i exbutton , fs_label); 
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Sample C language binding: 

/'" Example binding for fsel_exinpur() 

■ This code is an example of hew to use fsel_exinput until you 
9 et a set of libraries for your compiler that includes the 
fsel_axinput routine. 

-/ 

#inciuae ^osbind.h; 

^define FSEL_EXINPUT 91 


E 

•/ 


If you want the binding 
set PATCH_CTRL to 1. T 
have patched ctrl_cnts 


__to patch the ctrl_cnts array at runtime, 
f you don't want it patched at runtime (i 
in your library source) set PATCH_CTRL to 


. e . 
0. 


^define PATCH_CTRl 1 


you 


/* 

External!'.' 

,•/ 

extern char 
extern int 
extern long 
extern 


defined things 


ctr i_cnts 


US] ! 3 ~ 


i nt_out [] 
addr_in[] 
crys.ifQ 


/" control array 
/ " Aco arrays **"/ 

/- AES interface 


parameter counts 
function */ 


int 

char 

int 

char 

! 


fsel_exinput( path, file, button, label ) 
-path, •-■file; 

“button ; 

-I abel ; 

register int *i ; 

regi star 1 ong -a ; 

register char •■'c : 


get 70S version number */ 
long savessp = Super(OL) ; 

unsigned TOS_version « -(unsigned int -)( -(Iona -)(0xAf2) - 2 )- 
Super(savessp) ; •* 

/* iT old TOS version, just do fsel_input() */ 
if( T0S_version < 0x0104 ) 

return ( fsel_input( path, file, button ) );• 


#if PATCH_CTRl 

/ Patch ctrl_cnts array with correct control array parameters */ 
c = &(ctrl_cnts[FSEL_EXINPUT-101[0])- 
if( (c [ 1 ] !- 2)| |(c[2] !- 3) ) { 

*c- + = 0; 

-C++ = 2; 

-c = 3; 

#endi f PATCPLCTRL 
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sat up parameter blocks -'/ 
i = i nt_out ; 
a = addr_in; 

-an- - (long) path: 

*a++ - (long) file; 

*a - (long)label ; 

/* call the AES */ 

crvs_if( FSEL_EXINPUT ); 

/"' and return 

"button = i [1] ; 
returnC i [01 ) : 
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11.3.10 WIND_NEW 

Purpose: Closes and deletes all windows, resets the wi nd_update() iunction, Mushes all the windows' 

buffers and restores mouse ownership back to the system. 

Parameters: control (0) = 109 

control (1) = 0 
control (2) = 0 
control (3) = 0 
control (4) = 0 


Sample call to C language binding: 
wi nd_ne\vQ ; 
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VDI Changes 

Mouse Code: 

VDI Mouse Code now supports screens larger than 32K. This allows higher- 
resolution monitors (i.e. Moniterm). 

vsi_extent(): 

vsT_extent() now works correctly when rotation is 270 degrees. 

vq_mouse(): 

vq_mouseO has been mace more reliacie through a code rewrite. 
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GEMDOS Changes - Character I/O 


GEMDOS Changes - Character I/O 


Cconrs: 

Cconrs now handles keystrokes where the high-order bit ol the ASCII code lor 
the character is 1. 

- Cconrs no longer echoes the input line to the console when the standard input is 
redirected to come from a tile. 

Cconws: 

Cconws is faster than before when handle 1 is redirected to a file. 

Character i/0: 

Character I/O functions (including 'Crawio' and 'Cconout ') work predictably 

when redirected. In particular, input and ouiput status, and Cconout work when 
redirected. 

Control-S and 
Control-C Handling: 

Console handling of *S and "C is consistent. ~C during any "cooked" input or 
output function (Ccom'n, Cconout, Cnecin, Cconws, Cconrs, ana 
rread from a console device) causes the current process to terminate. 

Standard handles: 

Closing a standard handle (0-5) causes it to revert to its default BIOS device 
definition: previously this was undefined. The normal way to deal with a standard 
handle is to Fdup it to make a copy. Fforce it to whatever you want, then 
Frorce from the copy when you're done to revert back to what it was. Closing 
now works, to at least get it back to a known state. 

Type-ahead: 

- Console input type-ahead buffers are implementea correctly, and no longer grow 
■without bound into the surrounding memory. 
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GEMDOS Changes - File Functions 


Archive Bit: 

i he "archive " altribute bit (0x20) is now correctly maintained: it is set when a file 
is created or modified. Archive/backup programs can check this bit to see if the 
file needs to be backed up. and can dear the bit when they have backed it up. 
See "Attribute Byte" in GEMDOS Supplemental Documentation. 

Duplicate Filenames: 

~ GEMDOS now prevents dupiicaie filenames: it no longer occasionally creates 
two files with the same name. 

Fattrib: 

Fattri b checks the legality of what is being atiemptea: tor example, an attemot 
to change the directory bit of a fiie or subdirectory wiil be denied. 

1 

Fdatime: 

Fdatime no longer byte-swaps the user's input values wnen writing a new 
date/time. 

Fdatime returns EI.HNDL tor invaiiG handles and handles which refer to 
character devices (which have no date or lime). See i satty in GEMDOS 
Suppiemental Documentation. 

Fread and Fwrite: 

tread and Fwri te with a length argument oi zero cc not hang. 

- Fwrite calls which wriie to a character device >'CCN. AUX. PEN) are nc longer 
limited to 16K - 1 characters. Applications shouic stiil limit writes to retain 
compatibility with other versions oi ICS. however. Fread calls which read from 
a character device have always oeen limited to 16K - 1 characters, and still are. 

Fsetdate and 
Fsettime: 

Fsettime and Fsetdate cause the BIOS time and cate to be set. too. The 
reverse is also true: setting the BIOS date and time affects the GEMDOS values, 
i his is the same behavior as in the 4/22/87 (Mega) ROMs, where it is necessary 
for the real-time clock chip. 

Redirection: 

Redirection to the printer (handle 3. ”PRN: ”) works correctly. Previously, 
GcMDOS would make the BIOS cafl for input status on the printer device, which 
is not supported. 

Sector Buffering: 

Sector buffering in GEMDOS has been improved, and the user can add buffers to 
the FAT/root directory list to improve performance dramatically. Old buffering was 
inefficient, and (in one case) actually wrong. See "GEMDOS Buffers" in 
GEMDOS Supplemental Documentation. 
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GEMDOS Changes- - Directory Functions 

Dcreate: 

- Dcreate (mkdir) now detects and handles errors: it recovers correctly from 
failures while creating a directory (such as write errors and disk-lull errors), and 
does not partially build subdirectories. 

- Attempting to Dcreate a directory with the name of an existing file will return 
R4CCDN. Previously, it would delete ihe file, then create the directory. 

Ddelete: 

- Ddelete immediately following a Dcreate now works correctly. Formerly, this 
would fail but a second Ddel ete would work. 

Folder Limits: 

- The so-called "40-iolder bug" is fixed. There are still limits, mainly on the depth of 
folders and the accumulated depth of open files, but these limits are very far away 
and can still be extended with "FOLDRXXX.PRG" which is widely available. Also, 
a folder only takes up space when it is "active", not just when you’ve seen it. See 
"OS Pool Discussion." 

Frename: 

- Frename can now rename a foider: ii cannot, however, move the folder around in 
the directory structure, the way it can a iiie. 

- The entries ior V and in subdirectories are correctly date-stamped. 
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GEMDOS Changes - Processes and Memory 


Malloc: - By and large. She restrictions on Mai IOC have been ;ilted. (i.e. the 20 

b:ccks/process iimii.J .'vial "l OC Still uses the same internal OS Pool as tolcers. 
so it should still be used sparingly. Use Mai loc lor large chunks, and use 
another manager (such as a C compiler library s mal locO function) lor ge.neral- 
buroose memory management. Also. FGLDR100.FRG can be used to add to the 
CS Pool, which both subdirectories and Mal loc use. See 'OS Pool Discussion. " 


OS o c i : 


- internal usage of ine OS Pooi has seen vastly improved, see ob . ooi 
discussion. 

- An exhausted CS Pool now resuits in predictable land sate) behavior. The 
machine will lock up with a message to the effect that the pooi has seen 
exhausted, and that you need to use FOLDP.XXX.PRG to enlarge it. It no ionger 
Gives incorrect results: nor aoes it damage disks. 

- The, OS Pool has been reduced to 11/20/85 size. This may allow some programs 
tha't ran on 520STs with 1 1/20/85 ROMs but tailed to run with Mega ROMs. 


Fexec: 


- p=xg.~ handles excsoticnai cases correctly: it no ionger causes bombs or leaves 
tiies open, a.nc it releases memory correctly. 

* = exec desis correctlv with tiles having more than 22K oi relocation information. 

■ -exec Mode 5. 'Just Go. Then Free', has been acded. Mode 5 ;s simiiar to Mode 
o except memorv ownersnio is changed to the chiic process: when the chiid^ 
terminates. GEMDC-S trees any memory allocated to the child, including its i PA. 
See "Psxec " in GEMDOS Suaciemental Documentation lor mere information. 


- Procram starred ;s as last as Mega r.GMs: faster than 1 1/20/85 ROMs. 

- “he” second oi me two reserved icngworcs in a PRG file header is no longer 
reserved: ii is now defined as a bitmap oi requests for new features. When the 
icwest-orcer bit. 0x0000000 i. is set. it indicates that Pexec should not bother to 
clear the orogram s entire heap, only the declared ESS. i his shaves up to one 
seco/id off program ioad time on a Mega 4. Many programs can have this bit set 
with no ill effects: it is generally considered bad practice to assume that 
'"siack-i-heap" space is clear wnen you start up. Some programs cannot have the 
bii set. ana this is wny the deiault tzero) case is to clear the heap. 


Program I ermination: - When a program is terminated with bombs (bus error, address error, etc.), its 

csrent's Pexec Q call returns with error code OxOQOOIIff. Previously, it returned 
with error code 0. 
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GEMDOS Changes - Other 


The structure of the private part o! the DTA (used for Fsfi rst/Fsnext) has 
changed. Applications that were counting on its (reserved, undocumented) 
structure may cease to function properly. 


FA I Search Code: - ihe FAT searching code for hard disks and flopoies is much faster. This 

speedup is especially dramatic when using "Show Info...", or when creating a file 
on a heavily loaded hard disk. 


FA I s ( 1 2 bit): 


i he 12-bit FA i code now deals with disks of up to 4096 clusters correctly. 
(Formerly, only 2048 clusters worked: above that there were sian-extension 
problems.) 


Media Change: 


GEMDOS now recognizes 'media change" better. It would sometimes fail before 
because GEMDOS was. in effect, using a cache without checking for media 
change. 

MediachO is more reliable when using logical drives A: anc B: on a sincle-drive 
system. See "Forcnc 'Media Chance'." 
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GEMDOS Supplemental Documentation 


Attribute Byte: ■ I he Attribute Byte looks like this: 

Comments 

Denies delete and open for write. 

See below. 

See below. 

Exclusive (no other bits should be set) 

Exclusive (no other bits should be set) 

Fiie is new or has been modiiied. (Doesn’t work 
in old system, does in new.) 

File attribute 0x08 is exclusive: no other bits should be set. Same with 0x10. 

Files with illegal attribute combinations are not guaranteed to work predictably. 

This is an ordered list ot matching rules lor attributes in Fsfi rst / Fsnext 
searches: 

1 

1. If input attribute == 0x08. include ONLY if (file attribute == 0x08). 

2. If file attribute & 0x21 (archive or P./O). or file attribute == 0. include. 

3. If ((file attribute) & (input attribute)) != 0. include. 

So. with "i a” the input attribute and "fa" the file attribute, match if 
this expression is TRUE: 


Attribute bit 

0x0 1 

0x02 

0x04 

0x08 

0x10 

0x20 


Name 

Read-only 

Hidden 

System 

Volume label 

Subdirectory 

Archive 


( ( ! r a && (i a ! - S') ) ! i ((.is ! 0x21.) & t a ) ) 

(ifa && (ia != 8) ) means fa 0 matches any search except 0x08. 

((ia | 0x21) & fa) means a one bii match between fa and i a matches, but 
also that fa with archive or read-only set will cause a match regardless. 

This means that tor a Hidden file :o be hidden, it can't be R./O or ARCHIVE. 

Same for system. A tile which is both hidden and system (but nothing eise) wiil 
appear when either of these bits is set in the input attribute. 

Subdirectories are included when (input & 0x10) != 0. Same with labels and 
(input & 0x08) != 0. 

You cbn Fc reate files with any combination of the ARCHIVE. R/O. HIDDEN, 
and SYSTEM bits. You can’t use Fattri b to change to an illegal combination, 
and you can't use Fattri b. Frenatne. Fopen. or Fdel ete on labels or 
subdirectories. 


D I Ai - If an Fsfi rst or Fsnext call returns a nonzero value (meaning faiiure), you 

cannot assume the DTA contains any useful information. 
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Environment String: - me environment string passed io Pexec is defined as a s of n ull-terminat&H~ 

strings. The suggested format for these strings is the sam* n n«;'anri 

UNIX (where $0 means a null byte): ’ u 


NAME1- val uelSO 
NAME2=vaiue2S0 

NAMEn=val uenSOSO 

All that’s enforced, however, is the trailing double-null: the *»Mvlfonment strinq is 
copied up to the first double-null. ‘ ^ y ~ 

- The default environment that gets set up for the \AUTO\ io|i| 0( and Desktop ( aRH 
therefore programs started from the Desktop) has a couple </j {aec 'iiari'lies ° 

It consists of these byres: 


PATH=S0A : \S0S0 
1 

The first SO shoulG not be there - environment variables are htean; to have the 
name, an equals sign, and the vaiue. ending with a null byte 

The second problem is that the drive letter is always A:. Some 

mciuatng some versions or Ar-tDI. cnange this environment =., r these 

reasons, this environment string is useless. Don't use it. 


Error Numbers: 


- GEMDOS error numbers are 
and ENSAME is -43. 


documented incorrectly: ENMF\ V ~ ^ not .47 


Fdatime: 


1 he arguments to rdattme are documented incorrectly: rv , 


Fdat i me ( t i mept r , hand 1 e , wf 1 ag) 


me '-‘timeptr; 
int handle; 
int wflag; 


to 


i n: 


■Nb— e— usage is: 


pti 

/- handle to read/write ••/ 

1 to write from timeptr to file, 0 






Fdelete and Frename: - If you Fa'el ere a fiie which somebody else has open, it wuit ^ if you 

Fdel ete a file which YOU have open. GEMDOS closes tht^- deleg S 

ii. Unfortunately, there's a bug: GEMDOS closes the fiie. pyt ^ y| e s hapy e 
The handle lives on in the OS Pool, taking up space foreves. doesr> 

even //yto close the file or deny access. 

The moral is. "Don't call Fdel ete or Frename on files roen “ 
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Frename: - Frename can move a file from one directory to another without copying it and 

deleting the old one. assuming that both pathnames are on the same drive: 

Frename (0 , "\ fol drl\foo . doc" , “\fol dr2\foo . doc” ) 

moves foo . doc from fol ari to fol dr2. This has always been true. 


GEMDOS Buffers: - You can add buifers to GEMDOS -- they won't work exactly like a cacne. but it 

wiil be close. It can make hard disk i/C- up to 10 times faster. There are two 
buifer lists: one tor FATs and root directories, ana one for the rest of the aisk. 

A ouffer control block looks like this: 

_bufl = S-b2 ; two buffer-list headers 


_bcb 

structure , 

pointed at by 

_bufl : 


B_1 Ink: 

.AES 
as . 1 

1 

; - • nexc 

BCB 

8_neal : 

G 5 . Vv 

1 

» * 


B_pri v : 

as . w 

5 

: private 

parts 

B_bufp : 

as . 1 

T_ 

j — Cute 

buffer 

6C3_size 



; hew big 

is it 


Or. in C: 


typedef struct _bcb { 

struct _bcb •'•'b_iink: 

i nt b_negl: 

int b_pri vats [5 ] : 

char *b_buf; 

} 3CB ; 

To add buffers, you must firs; find ou; what hard disk driver is running. This is 
important because it your buffers aren't the right size, the hara disk driver wiil 
obliterate the data in memory after the buffer. The normal sector size is 512 
bytes, the same as a physical sector, if you are running AHDI 3.0 or later, it is 
possible that the logical sector size may be more than 512 bytes. Here are some 
more definitions: 


Defsi ze 

= 512 


; default sector buffer size 

pun_ptr 

- S516 


; pointer to pun_info struct 

pun_info s 

tructure 

pointed at 

by pun_ptr 

MAXUNITS = 15 

.ABS 


; max number of physical units 

puns : 

ds .w 

1 

; number of physical units 

pun : 

ds . b 

MAXUNITS 

; physical unit for each logical unit 

part_start : 

ds . 1 

MAXUNITS 

; start of partition on the phys. unit 

P_cooki e : 

ds.l 

1 

; only exists after 890302 version 

P_cookptr : 

ds.l 

1 

; points to cookie 

P_version: 

d s . w 

1 


P_max_sector : 

ds . w 

1 

; max sector size being handled 
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i he following code irsgment will leave the correct sector buffer size in register d7: 


Get sector buffer size 


getSi ze : 

move 

ffDefsi ze , d7 

assume default size 

move . 1 

pun_ptr,aO 

get address of pun structure 

1 ea 

P_cooki e(a0) , al 

get address of AHDI cookie 

emp . 1 

# ’ AHDI ’ , (al) 

cookie? 

bne . b 

useDef 

no, use default 

emp . 1 

4(al) , al 

check the cookie pointer 

bne . b 

useDef 


move 

P_max_sector(aO) , d7 

set sector buffer size 

useDef : 

Or. in C: 


#define MAX UN ITS 16 


typedef struct 

_pun_info { 


i nt 

puns ; 


char 

pun [MAXUNITS j : 


long * 

part_start [MAXUNITS] ; 


1 one 

P_cooki e : 


1 ong 

'••P_cookptr : 


unsi coed 

P_version ; 


l nt 

P_nax_sectcr : 


} PUN_INFC: 

int getSizeO / 

• v returns correct size of sector buffers -'/ 


f 


lone savessp = Super(OL); 

register PUN_INFO *pinfo = -'(struct _pun_info (0x515) ; 
Super(savessp) ; 


if( (pinfo- P_cookie == Ox^iaszzaa) && 

(pinfo--P_cookptr == SJpinfc- P_ccokie) 
return pinfo- P_max_sector ; 

else 


return 512; 


) 


Cnce,you have the correct buffer size, do the following: 

1. Allocate a BCS (let's call it 'b'). 

2. Allocate the buffer for that BCB (let's call it ’bb‘). 

3. Set b.b_neg1 to -1 ($ffff). 

4. Set b.b_bufr to point to bb. 

5. To add this buffer to the FAT/Root Directory list, set b.bjink to the current 
value of _bufl[0] (the longword at S4b2). and set _bufl[0] to &b. To add this 
buffer to the other list, set b.bjink to the current value of _bufl[1] (the longword 
at $4b6). and set _bufl( t j = &b. 

Repeat the above once per buffer you want to allocate. Then terminate 

and stay resident, reserving the buffer memory that you just gave to 

the OS. 

A much easier way to add buffers to the system is to use the program 

CACHEnnn. available from Atari. 


EA/NBOW TOS EEL. EASE NOTES -AUGUST 7, 1989 


Page 43 



GEMDOS Supplemental Documentation 


ikbd driver state 
variable: 


- Kbdvbase returns a pointer to a list of vectors tor the IKED/MO subsystem. At 
offset S24 from that pointer is a byte which is the ikbd driver state variable. This 
has aiways been true: it’s now being declared official, and will remain true. 

The only supported use for this variable by outside programs is to determine if the 
IKBD is in the midst of sending a packet of some type. The variable is nonzero 
when the IKED is sending a packet, and zero when it's not. 

Programs which want to change the keyboard handler vector should do so only 
■when the driver is not processing any packet {i.e. when the variable is zero). 
Since there are hign-speed interrupts involved, some care must be taken. This 
code fragment should suifice: 


Called from supervisor mode, this subroutine safely changes the 
keyboard handler vector to its argument (on the stack) and returns 
the old value of the vector, in dO. 

This code is tricky because it is possible for an interrupt to 
arrive between the time we find the state variable to be zero 
and the time we change the vector. So another check is made at 
IPL / to be sure. 


_setkvec : 

move.w =!<bdvbase . - (sp) 

trap #Se 

addq.l #2,sp 


move . 1 dO.aO 

movs ' : 720(a0),d0 : get old vector value to dO 

: now wait until the IKBD isn't processing a packet (wait until the • 
: ikbd state variable is zero). 


n x. \ x. s z . o 
bne 


•7 die 


state variable is zero: check it again at IPL 7. 


move . '.v 

' sr.al 


o r . vv 

#S0700. sr 

; go to IPL 7 

tsr . b 

S24(a0) 

; still idle? 

beq . s 

okZchange 

; if yes, go finish up. 

move . w 

dl , sr 

; not still idle: drop IPL 

bra 

wai t 

: and try again 


okZchanae : 

move . 1 4(sp),S20(a0) 

move.w dl,sr 

rts 


set the new value (still IPL 7) 

go back to old IPL 

return. Old value is still in a'O. 
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isattyO: 


- Some compiler libraries did strange things to implement i salty using Fdatime. 
The approved method of determining i satty is: 

int i satty (hand 1 e) - 
i nt handle; 

{ 

long oldoffset; 
long re; 

oldoffset = Fseek(0L . handl e , 1) : 
rc = Fseek(lL, handle, 0) ; 

Fseek(ol doff sat , handl e , 0) ; 
return (rc != 1); 

} 


exec: 


- i he correct arguments tor Pexec are (and always have been): 


long erreode = Pexec(0 . prgfi 1 e , cndl ins . envptr) 
long basapage = Pexec (3 , prgfi 1 e , cmcl i na . envptr) 
long erreode = Pexec(4,0L, basapage, QL) 
long basapage = Pexec(5 ,0L , c.tcl i ne , envptr) 


/•• load & go -/ 

load, don’t go */ 
/- just go ■■/ 

/•• just create a 
basapage */ 


char •■'prgfi le: 
char •■' c~dl i ne : 
char '''envptr: 


/• the file to load '•'•'/ 

/-' command line: first byte is its length '■'■'/ 

/'- 01 or points to dcubl e-null -terminated env '-/ 


If :he envptr argument is 0L, the cniid inherits a copy of your environment. See 
the discussion oi the environment string for more about this. 


Pexec mode 0 is the only one wrier, really works reiiabiy. The others run into 
trouble with memory and tile ownership anc things like that. Use them only with 
exireme caution, after you have read the Atari Pexec Cookbook. 

It has always been true that programs are started at IPL 0. This is now official 
and will continue to be true. (HSLANK interrupts at level 2 and the default 
handler increases ihe IPL to 3. so the system normally runs at iPL 3.) 


■ Pexec in Rainbow TOS supports a new mode, called 'Just Go. Then Free', or '6'. 
This mode executes a loaded process which owns its TPA. The child’s memory 
is freed when it exits. Returns values in the same manner as mode 0. An 
example cf this call is: 

LONG Pexec(6, OL, BASEPAGE *basePage, 0L) ; 

This function is available only in TOS versions 1.4 (GEMDOS version 0x1500) or 
higher. It functions like Pexec mode 4, with one important exception: memory 
ownership is changed to the chiid process. When the child terminates. GEMDOS 
frees any memory allocated to the child, including its TPA. For more information, 
see the Atari Pexec Cookbook. 
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SuperO: 


- The Super() call is incorrectly documented: Super (1L) interrogates supervisor 
mode. It returns -1 L if you're in super mode, and OL if user mode. [ i he original 
documentation said that Super(-IL) returned 1L if in super mode. In fact. 
Super(-IL) gives an address error.] 

Super(OL) , when called from user mode, returns the old supervisor stack 
pointer, and returns with the processor in supervisor mode, i he argument OL 
means "use my old user stack as the supervisor stack. There is usually plenty of 
space on the user stack for both you and any interrupts, etc. which come along. 

When called from Supervisor mode. Super returns to user mcae: it is a toggle. 


i he SuperO call is intended to work like this: 

extern long traplQ: 

^define Super(x) trapl(0x2Q . x) 

super_sampl e() 

{ 

long oldssp: 

get super mode '-/ 
oldssp = Super(OL); 

do stuff in super mode; ssp is old usp. Don't call AEu ! -/ 

/■'• get back to user mode 
Super(ol dsspj : 

There may be some vagaries of using it in other ways: be caretui. Calling AES 
will blow up in a big way. because AES uses the User Stack Pointer (usp) to 
store your registers, even if it's called from Supervisor mode. 


Page 46 


RAINBOW TOS RELEASE NOTES - AUGUST 7. 1989 



GEMDOS Supplemental Documentation 


System Variables: - Starting with the Mega ROMs, there are three more system variables you can get 

at: pointers to them are in the system header block. A pointer to the system 
header block can be found at address $4(2 (_sysbase). Do not assume that the 
system header is in ROM. or that the ROM starts at FC0000. See "OS Header" 
in BiOS/XBIOS Supplemental Documentation lor more information. 

At oifset $20 from the address at _sysbase is a pointer to the variable 
”_root . " _root is a pointer which holds the base of the OS Pool, the internal 
memcrv used by GEMDOS. This pointer is used by FOLDP, 100. PRG. You can 
still acd pool to the OS the' same way as before, but you should know that the OS 
wiil taKe the pool you added and use it DIFFERENTLY from the way it w as used 
before. The rule is. once you give memory to the OS. DON i TOUCH 1 1 after 
that. See "OS Pooi". and "OS PggI Discussion" for more information. 


At offset $24 from _svsbase is a pointer to the variable kbsht ft. a byte 'which 
hclos the keyboard shift state bits. 

A; offset $23 from _sysbase is a pointer to the variable _run. a longword which 
hoics the process ID (basepage adcress) of the process GEMDOS is currently 
executina. See "OS Header" in BiCS/XEIOS Supplemental Documentation for 
more information. 

Ail these variables are for READING ONLY - unpredictable and bad things can 
happen if they are written to. kcsm zz ;s the most useful of these, because it 
lets you check tor a keyboard shiit key sequence very quickly. For instance, the 
(Gilowinc combination of routines can be used to test for both lett and riont shift 
keys down, which might, for example, cause a break in your program. 


char •• v p_kbsht fa : 


i ni t() 

long _5ysbase = *((1ong ")0x4fc}t 


i f 


•■.unsigned *)(svsbase - 2 ) -*-* 0x0100) 
p_kbshi ft = (char OOxelbL: 


e l se 

p_kbshi ft = -(long *) (sysbase^-OxZ^) ; 

; 

edefine kbtestQ { if (( * (p_kbshi ft) Si 0x03) 0x03) abortQ; } 

After i ni t () is called, using the macro kbtest () inside the main loop of your 
program is a fast way to detect both shift keys down. This is much faster than 
using the Kbshi ft() BIOS call, and amounts to the same thing. 


Version Numbers: - The 1 1/20 (original) ROMs have the version number $0100 as the second word of 

the OS header, which is pointed to by _sysbase. (at $4(2). 

- The Mega ROMs have the version number $0102. 

- Rainbow TOS ROMs have the version number $0104. 

- The version number is the best way to check the version of the ROMs. You can 
check the GEMDOS version number specifically by using the Sversion call, and 
you can check the date in the OS header, but the version number is the best bet 
because it is the same across all countries, whereas the date sometimes tsn t. 
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Volume Labels: - The only available oceraiions on volume labels are Fsf~ rsz ii bit 0x08 is set. 

you'll see them) and Fcreate. 

' FcreateCf i 1 e , 0x08) will create a volume lace! IF the ‘lie anas up in the root 
directory oi a device. Otherwise you get EACCDN. 

- Once you Fcreate a volume laoei. you snouid Fciose :he nancle immediately, 
inis is not enforced, but any data you write to the nancle is ros; forever. 

~ Eefore the new label is created, any labei on iha: device is deleted. (Weil, 
specifically, the first file in the root directory ot the device with attributes == 0x08. 
if any. is deleted.) 

- You can create a voiume iabei with the same name as an existing file, or vice 
versa. Both will coexist just fine on. the disk. 

- You cannot Fdelete. Frename. or Fattrib a volume lacei. 

- You cannot use Fattri b to make a tile into a volume lacei. 

"You cannot remove a volume label. (Eui see above: you can rename one simpiv 
by creating one with the new name.) 

- In the old GEMDOS. people sometimes did this to create a new label: 

i 

Fsetdta(<sdta) ; 

if ( ! Fsf-i rstCW* . ,0x08)) { 

/* a label already exists: delete it. 
fd = Fcreat s dta . name . 0 ) : 

Fciose(fd) ; 

Feel ete(dta . name) : 

fa ’ Fcraatet "\\mylabel " ,0x05) : 

Fclosef fd; : 


i nis sequence worked because Fcreat Sing a fiie with the same name as the 
laoei would remove the labei. Then you couia delete the rite, ,-aving done that, 
you know the last Fcreate vviil be the only voiume lacei cn the disk. 

Weil, this sequence will still work. The clause wn.tcn c.necks tor sne deletes an 
existing label is not needed, but harmless. The last Fcreate will reetace the old 
volume lacei with the new one. 

in the oid GEMDOS. the above algorithm wiil wipe out an existing file which has 
the sa/ne name as the NEW label. In the new one. it wiil wipe out a liie with the 
same name as the OLD label. The advantage of the new GEMDOS is that you 
don't need the first clause at all: just Fcreate the new lacei. and you won't wipe 
out any files at all: 

fa = FcreaieC "\\myl abel " , OxOS) : 

Fcl ose(fd) : 


i his works whether you already have a label or not, and wrtetner you have a tile 
called my 1 abel or not. and it doesn't wipe out that file ii ii exists. 

OI course, since programs should run on any system with any ROMs, and you 
should do error checking, the following code will work best. 
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/ 

Program to change a disk's volume label. 

Should be run from the volume's root directory. The single command-line 
argument should be the new label to create. Any old label is removed. 
Works for all ROM versions, both pre- and post-TOS 1.-. 

This code is for Alcyon, but should compile under almost all ST 
* compilers. 

Written by Allan Pratt, of Atari Corporation, October 12, 19SS; released 
to the aeneral public to be freelv used and cooled with no restrictions 

*/ 

^include -osbind. fl- 
int romvers: 

1 ong mkl abel () ; 

I 

mai n(arac , argv) 
int arac; 
char *arav[] : 

r 

\ 

long oldssp: 
int ■‘sysbase: 
char new! abel [14] : 
char pathbuf [128] : 
extern char *index(): 

oldssp = Super(OL); 
sysbase * -'(int **)0x4f2 ; 
romvers = (sysbase-1) ; 

Super'.’ol assp) : 

Oaetpath(pathbuf , 0) : 

if ('-pathbuf !- ' \0 ' II /■■' must run from the root directory 

argc !- 2 !i /"■ expect exactly one argument '-/ 

argv [1] [1] == !| which must not have a drive spec '-/ 

index(argv[l] , “\\")) { ...or a path spec 

Cconws("Usage : label <newlabel ; \r\n" ) ; 

CconwsC'Must be run from the root di rectory , \r\n" ) : 

Cconws("and < new! abel • must be a simple file name . \r\n” ) ; 
Pterm(l) ; 

} 

copy the argument because Fsfi rst may overwrite it! */ 
st rncpy(newl abel , argv [1] ,12) ; 
newlabel [12] = '\0' ; 

if (mkl abel (newlabel )) { 

Cconws ( " Fai 1 ed . \ r\n '' ) ; 

Pterm(l) ; 

} 

PtermOC) ; 

} 
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.mklabel: ini's procedure creates a new volume laoel on the currant dri 
replacing ar.y existing label. The currant di ractory must be the root 
of the drive you want to craata tne luDGi on. and une drournenT /nusu 
not contain a drive or path specifier. 

(Those restrictions are not demanded by Fcrsate: they're demanded 
by the section of code inside "if (romvers • 0x0104)" because that 
way Fsf i rst('"'‘ 0x08) will refer to the same drive & directory 
as the label you're trying to create.) 


met _dta 

char rase rved [21 j : 
char attr; 
int time: 
int data; 
long size: 

char name [14] : /'•'•' null termi natad ■■'/ 

'•'■'dta; ; 

ng mkl abel (newl abel ) 
gistar char '''newl abel ; 

register long err: 
register int fd: 
extern int convert: 

/'■'■' If earlier than TGS 1.4. delete the ole label. '■■'./ 

/'■'■' Assume that romvers has beer, set elsewhere. '■■'/ 

if (romvers - 0x0104) { 
dta => FgetdtaO : 
err - Fsf i rst OxOS 1 : 
if (;rr == 0) •' 

/'■•' An old laoel exists: create a normal file with -'/ 
/'•'•' the same name, then delete that new file. '-'/ 

if ((fd - err « Fcreatefdta-' name . 0) ) - 0) 
return err: 

Fclose(fd) : 

Fael eteyata- name) : 

} 

i 

i 

if ((fa = err = Fcreate(newlabel .0x08)) - 0) 
return err; 
err = Fclose(fd) : 
return err; 
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OS Pool Discussion 


There are limits internal to GEMOOS which programmers using it must understand, in a oroad sense, you 
should know that these limiis have to do with the maximum depth oi your hierarcnical tiie structure 
(subdirectories), and the number of open tiles you can have at once, in most cases, users will never come up 
against any of these limits. 

The limits come into play when you have lots oi tiles open at the same time, and they are oeep in different 
subdirectory trees. Also, programs which call the operating system junction Mai loc tmemory allocator) 
influence these limits — lots of Mai loc calls means less space is avaiiabie tor keeping track of open files and 
the subdirectories leading up to them. 

Technically, the limits are as follows: there are 30 blocks in the system's "OS pool. " Two clocks are used per 
active (cider. An "active" folder is one which is the root directory oi the device it's on. or which nas open fiies. 
or which is the current directory of one or more processes tor -hat drive, or which has an "active' antic 
(subdirectory). Yes. this is a recursive definition. Remember that each process has a current directory on 
every logical device, but also remember that one folder only takes up two blocks, no matter how many reasons 
it's "active." 


addition, one block is used per open tile, ana i/4 block is used per memory chunk t allocated or tree) in the 
-system TPA. In this context, an "open" file is one which has been Fopened ana not Fclosed: this is not me 
same as the "Open" operation in an application. 

When files are closed, processes terminate, or memory chunks are treed (anc coalesce into larger tree chunks) 
blocks are Ireed back into the OS oool. 


The Imcroveme.nt over previous ROMs is this: tne old definition of "active" was "seen" - getting a list oi the 
fiies in a directory caused ail the folders there to take up oiccxs in the oooi. in sedition. blocks never got freed 
in the pool. Also, once parts oi the pool had been used tor managing TPA memory cnurtKS. they were 
unavailable for managing folders, and vice versa. All these restrictions are lifted. 


It is stiil possible to run out of pool, of course. The program FOLDF. iCO.PP.G was releasee by Atari anc is part 
of the HDX (hard-disk utilities; distribution. It acas memory to the CS oool. and it stiil 'works, adding memory to 
the new kind oi pool. too. Placing this program in your AUTO folder causes 200 more blocks to os adcec to 
the OS pool, which is room for 100 more tclcers trememcer, only ACTIVE toicers take uo room; or 300 more 
memory chunks, or any combination. For more information, see the .-CLEF. ICO. PPG documentation in your 
HDX manual. 


It should be stressed that this program usuaiiy will not be necessary. Only it you have an inordinate number 
and depth oi folders, open files, etc. will you run out of pool, because it is so much more efficiently managed 
than before. 

.he unlikely event that you do run out of pooi. the following message wiil appear on your screen: 

*** OUT OF INTERNAL MEMORY: 

USE FOLDR100 . PRG TO GET MORE. 

*** SYSTEM HALTED *** 


(This message appears in English regardless of the country you are in.) 

It is regrettable but true that there is nothing you can do at this point but press Reset. Remember what you 
were doing when this happened: were you trying to create a directory that was 50 levels deep in the 
hierarchy? Were you opening the 10th diiferent file in the 10th different subdirectory? If you reaily want to be 
able to do whatever you were stopped from doing, use FGLDR100.PRG (or increase the "100" if you're already 
using it). 

• 

Note: The system call Mai loc wiil never cause a panic: it wiil just return 0. meaning it couldn't satisfy the 
request. When this happens, however, you are on the hairy edge, because that means there is not 
even 1/4 of one block available for the memory manager. With any luck, the program that is being such 
a hog will notice that it's out of memory and terminate, freeing up enough blocks to be useful. 
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Forcing ’Media Change' 


l( a program changes the file or directory structure of a disk using SICS calls ie.g. a "disk compactor"), it must 
somehow inform GEMDCS of the change. Currently most programs go this by rebooting the machine, but this 
is not necessary. Instead, calling ihis routine will cause GEMDCS to aDandon all its cacnea information about 
the drive s files and directories, so the changes will be seen. If you do not use BIOS calls to alter directory 
contents on any drive, this routine is not necessary. ' 

i his routine can also be used in a program which cails Getbpb directly. Getbpb clears a drive's media- 
change flag, so GEMDCS vviil not know that new meaia is in the drive. The routine should be called after using 
Getbpb. before making any GEMDCS calls. 


tned-iach: cause media-chance on a logical device. 

USAGE: 

errcode = mediachf devno) ; /* returns 1 for error -/ 

int errcode. ddvno: 


ihis procedure causes a media change by installing a new 
handler for the mediach. rv;abs . and getocc- vectors: for device 
devno. the mediach handler returns "definitely c.nanced," and 
the r.vabs handler returns E_CH!MC. until the new cetbcb handler 
is called. The new getbpb handler un-installs tine new 
handl era . 

After irtstal ling the new handlers, this orocecure performs a 
disk operation te.g. open a fi ie,> which makes GEMDCS check 
the media-change status or the drive: this will t'iccer the 
new r.vabs. mediach and aetboo handlers to do their things. 

RETURNS: 0 for no error. I for error (GEMDCS never aia a 
getbpb call: should never happen.) 


.ied i ach : 


■a! obi _mediach 

move.vv 4(sp),d0 

move.w dO.mydev 

add . b ='A' ,d0 

move . b aO . fspec 


set drive spec for search first 
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loop : 


noclose 


done : 


cl r . 1 
move . w 
trap 
addq 
move . 1 
move . w 


-(sp) 

#520 , -(sp) 
#1 

#6 , sp 
dO , -(sp) 
#520, -(sp) 


move . 1 
move . 1 
move . 1 


5472 , ol dgetbpb 

S47e , oldmediach 
5476 , old rwabs 


move . 1 
move . 1 
move . 1 


#newgetbpo, S4/2 
#newmedi ach , 5 4 / e 
#new rwabs ,54/6 


; Fopen a file on that 


dri ve 


qet super mode, leave 
and "super" function 


old ssp 
code on stack 


move . w 
move . 1 
move . w 
trap 
addq 


#0 ; -(Sp) 

#f spec , -(sp) 
#S3d, -(sp) 

#1 

#8 , sp 


; Fclose the handle we jus^ 


got 


tst .1 
bmi . s 


dO 

noclosa 


move . tv 
move . w 
trap 
addq 


dO , -(sp) 
#S3e, -(sp) 
#1 

#4 , Sp 


moveq 
emp . 1 
bne . s 


#0 , d / ^ 

#newgetbpb , s4/ ^ 

done 


moveq 
move . 1 
move . 1 
move . 1 


#l,d7 

ol dgetbpb , S4/2 
ol dmedi ach , S47e 
oldrwabs , S476 


trap 

addq 

move . 1 
rts 


#1 

#56, sp 

d7 , dO 


. st -iH Installed? 

; nope 

. yup ! remove & return TRUE 


; go back to user mode (use stuff 
• left on stack above) 
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* new getbpb 

: if it 

's our device, uninstall 

vectors: 


in any 

case, call the old getbc 

b vector (to really 


get it; 



newgetbpb : 





move . w 

mydev . dO 



cmp . w 

“(Sp) .dO 



bne . s 

dool da 



move . 1 

ol dgetbpb . S“72 

: it's tine: un-install new vectors ■ 


move . 1 

oi cimedi ach , 5*^7e 



move . 1 

ol dr.vabs . S“7u 


dool dg : 

move . 1 

ol dcatbpp , aO 

: continue here whether mine or not: 




; call ole. 

— 

jmp 

(aO) 


new mediach: if v 

t's our device, return 2; 

S i 52 Cii i 0 1C . 

newmedi ach : 





mo ve . w 

mydev . dC 



cmp .'.v 

-isp; . dO 



bne . s 

dool dm 



moveq . 1 

#2 . cO 

: it's tine: return 2 (definitely change 1 


rt s 



dool dm : 

move . 1 

ol dmedi ach . aO 

: not tine: call old vector. 


jmp 

(’ aO } 
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newrwabs: return E_CHG (-14) if it's my device 


newr.vabs : 



move . w 

mydev , dO 


cmp . w 

Se(sp) , dO 


bne . s 

dool dr 


moveq . 1 
rzs 

#-14 , dO 

dool dr : 

move . 1 

ol dmedi ach , aO 


jmp 

(aO) 

. data 

■^spec : 

dc . b 

"X : \\X" ,0 

. bss 



mydev : 

ds . w 

1 

ol daetbpb : 

ds.l 

1 

ol dmedi ach : 

ds . 1 

1 

ol drvvabs : 

ds . 1 

- 


end of medi 

ach 


file to look for (doesn't matter) 


RAINBOW TOS FELEASE NOTES - AUGUS / /. 1989 


Page 55 



BIOS/XBIOS 



R '/< OS/XB / OS Changes 


BIOS/XBIOS Changes 


Boot Sequence: 

The ROMs check the DMA port (or bootable devices. Each device now gets a 
second chance if the first try at a boot sector returns an error. 

Disk Eoot: 

- Fioppies are checked for "bootaDility" on warm sndc old starts, even if an 
autobooting hard disk is attached. Before, this was done oniv on a cold boot. 

Disk Formatting: 

- Disks are formatted to be compatible with the IEM PC; BIOS protobt' creates 
MS-DOS format floppy boot sectors. Programs should place E9 00 4E in the 
first 3 bytes to insure MS-DOS compatibility. Programs which do not use these 
calls to format the disk wiil not be aifected. 

Floppy Seek Rate: 

A new call. Floprate. has been provided to check or set the seek rate for a 
‘loppy drive. See EIOS/XEIOS Supoiemental Documentation. 

Keyboard Repeat: 

- Keyboard repeating has seen improved: if you hii a key (say. ana hold it 

down, you wiil get lots of = 's. If you then hit 'S' without lifting your finger off you 
wiil get one S. then many 3's. The S's won't stop repeating until you let go of the 
S' key. even if you do let go of the s ' key in the meantime. 

Keyboard Reset: 

Reset is available from the keyboard. Hold down the <Control> and <Alternate> 
keys, and press 'Delete" (below "Backspace"). This accomplishes the same thing 
as hitting the reset button. 

- <Control><Alternate><F.igru Shift><Deiete> causes a VERY coin boot. It clears 
ALL oi RAM (except about 54 byies at the bottom; and then jumps to the ROMs, 
inis is to gei rid of reset-resident F.AMdisks. reset-bailout vector stuff, packages, 
and miscellaneous system variables that are clear on a cold boot but not touched 
by a warm one (notably _bootdevi. 

Rsconf: 

Rsconf (-2 , -1 , -1 , -1 , -1 , -1) now returns the last baud rate value set by 
Rsconf. If the first argument to Rsconf is -2. the rest are ignored. 

Rsconf was documented as 'void' but actually returns the old values oi the 
ucr , rsr , tsr, and scr registers. It always has. but wasn't documented 
as such until now. 
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BIOS/XBIOS 

Supplemental Documentation 

Bconcut: 

- Bconour so she printer returns 0 tor failure, and a nonzero value icr success. 

This is used lor the "Your output device is not responding" message in the 
Desktop, and is no; handled through, the critical error handler. This has been true 
oi ail ROMs. 


GEMDGS previous to Rainbow TGS jus: happened to return ihe leftover value 
from DO. so using :he GE.V1CGS Cpr’noutQ function returned this. too. New 
GEVtCCS explicitly returns the status from She SICS csil from Cprnout. 

BIOS Guipui-Slalus 

- The BIGS output-status functions icr ikbd and MIDI (devices 3 and 4. 
respectively) are reverses: 3costat;3) gives MIDI output status, anc 
Scosra~(4; gives Ikbc output status. We can't change these back because 
programs may already be correcting for this behavior. 

Ficpraie: 

■ Flop-rare. XBICS junction 41. checks or sets Ihe seek rate ior a floppy drive. 
This is new: ihe seek rate must be set with (previously) undocumented variables 
cn earlier versions si TGS. 


FI c-prace examcie: 


i nr dev.no . new rex e 

o i d ra c e - r ; c o r u r e ^ o e v n c . n e v» r e. r e . i 


Tills returns She current seek 'ate if r.ewrats is - otherwise sets the seek rate 
so newrate. rcr Going this with previous versions oi 70S. she seekrate byte 
locations ter Drive A and 5 are. 

CS Version Drive - Drive E 

uxUjLUO i-e.Uu o.-uu 

0x0102 SA4F SA 53- 

in either case, vatic seek rate byte values are: 


Value 

T'.S.IQ 

00 

6 ms 

01 

12 ms 

02 

2 ms 

03 

3 ms 


i his call does not range-cneck the drive ID or new seek rate value. If devno is 
zero, it assumes drive A:, if nonzero, drive S:. 

The following MACMAC source will give you a program which sets the seek rate 
on drive 3: to 6 ms. This could be used to hook up an Atari PCF-554 5 1/4" drive 
to an ST. for example. 


Face SO 
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pcf554.s 

Copyright 1988, 1989 Atari Corporation 
**** sets 6 ms seek rate for PCF-554 or other 5-1/4" floppy B 

.include atari 


* bios dsb structure 
.ABS 

Acurtrack: ds.w 1 
Aseekrt: ds.w 1 
Scurtrack: ds .w 1 
Bseekrt:ds.w 1 


current track# 
floppy's seek-rate 
current track# 
floppy's seek- rate 


* The following are UNDOCUMENTED BIOS BS5 variables: 


- dsb_05 = S6cS 


RAM TOS - unsupported by this program 

dsb_10 = 5a06 

; 11/20/85 


dsb_12 = Sa4c 

; 4/22/87 


.TEXT 



pea 

hel lo 


Gemdos 

59,6 

Cconws 

Super 



move . 1 

_svsbase , aO 

get TOS version 

move . w 

2 (aO) , d7 


User 



cmp . w 

#S0100,d7 

TOS 1.0? 

beq 

dolO 


cmp . w 

#50102. d7 

Blit TOS (1.2)? 

beq 

dol2 




TOS 1.2 

cl r . w 

-(.so) 

6ms seek rate 

move . w 

#1, -(sp) 

drive B 

Xbi os 

' 41,6 

Floprate call (TOS 1.4 and up) 

move .w 

#-l,-(sp) 

inquire rate 

move . w 

#l,-(sp) 

drive B 

Xbi os 

41,6 


tst . w 

dO 

did we do it? 

beq 

okf i ne 

yeah, get outta here 

pea 

nodi ce 

no, tell the nice user we had a problem 

bra 

punt 

and go away 

dol2 : 



lea.l 

dsb_12 , aO 

get Blit TOS dsb loc. 

bra setseek 


dolO: 



• lea.l dsb 

_10,a0 ; get TOS 1.0 dsb loc. 

setseek : 



clr.w Bseekrt(aO) ; set 6 

ms seek rate 

okfi ne : 



pea 

seekset 

; tell the nice user what we've done 
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punt : 

Gemdos 59,6 : Ccon'.vs 

PtarnO ; bye bye 

hel 1 o : 

dc.b "\n’\r \ep 5' 1 , SAC,"V' ST driver \eq\n\r" 

dc.b " Copyright " , S BD . " 19SS-9. Atari Corporation\n\r" ,0 

nodi ce : 

dc.b ” \ep Couldn't set Sms seek rate! \eq\n\r\n\r" , 0 

seekset : 

dc.b " \ep 6ms seek rate set cn B: \eq\n\r\n\r" ,0 

■■the 
. END 


OS Header: - As mentioned elsewhere in this document, the OS header contains a pointer to 

the GEMDOS variable _run. which holds the basepage address of the process 
which is currently running. This has only been true since TOS 1.2. so we are 
providing a subroutine below which returns the address of that variable no matter 
what ROM version you have. The GEMDOS variable _run is very important to 
TOS. and it shouid not be icoled .viih lightly, if you don't know what's going on. 
leave it alone. 

The address oi the variable in TOS 1.0 depends on what country your ROM was 
buiit for. The GS header is mean; to contain a code to indicate that. However, to 
fix a bug in some versions oi the Atari hard disk driver, this value is overwritten in 
the RAM coDy of the OS Header. Therefore, to get the country code, you have to 
look in the OS heaoer that's in ROM. Its address can be found in the OS header 
in RAM. in the iielc called OS_b€C. 


everything else about the copy oi tne OS Header in RAM is as advertised. 


~ 

he OS Heaaer sin. 

C *,l_ 

re is a 

s fellows: 


typedef sirs 

ct _osheader { 


' off: 

>et description 

-/' 

unsi aned 

os_eni ry : 

/ 

■ 300 

BRA to reset handler 

"V 

unsi aned 

os_version : 

/ 

• 302 

TOS version number 

'■'7 

char 

*reseth : 

/ 

• S0a 

reset handler 

'•/ 

struct osheader "OS_bea; 

/ 

■■ SOS 

- base of OS 

'7 

char 

'•' : os_end ; 

/ 

•• 30c 

- end 8IOS/GEMDOS/VDI ram usage 

"7 

char 

*os_rsvl ; 

/ 

•• 310 

unused, reserved 

"7 

char 

•■'os maaic: 

/ 

-- 514 

- GEM memory usage parm. block 

•* / 

1 ona 

os_date ; 

/ 

•• SIS 

Date of system build (SYYYYMMDD) 

7 

unsi aned 

os conf; 

/ 

■■ 31c 

OS configuration bits 


unsi gnea 

os_dosdate ; 

/ 

'• Sie 

DOS-format date of system build 

'7 

/* The next 

'V 

three fields ar 

a only available in TOS versions 1.2 and 

greate 

char 

•'■'-'p_root ; 

/ 

■ 520 

base of OS pool 

'7 

char 

* ••pkbshi ft : 

/ 

■ 324 

- keyboard shift state variable 

7 

char 

p_ run : 

/ 

• 528 

- GEMDOS PID of current process 


char 

-p_rsv2 ; 

/ 

• 52c 

■ unused , reserved - 

-/ 

} OSHEADER; 
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The country code is encoded in the os_conf word; the lowest-order bit indicates 
NTSC or PAL, and the other bits contain the country code. These are the country 
code values so far; other values are added as we make ROMs for other countries; 


#def i ne 

USA 

0 

/- 

United States of America -'/ 

#defi ne 

FRG 

1 

/- 

Federal Republic of Germany '-/ 

#def i ne 

FRA 

2 

/- 

France '-/ 

#def i ne 

UK 

3 

/- 

United Kingdom '-'/ 

£def i ne 

SPA 

4 

/"■" 

Spain '-/ 

#def i ne 

ITA 

5 

/* 

Italy '-/ 

£def i ne 

SWE 

6 

/--■ 

Sweden '-/ 

#defi ne 

SWF 

7 

V- 

Switzerland (French) -/ 

#defi ne 

SWG 

8 

/* 

Switzerland (German) -/ 

#defi ne 

TUR 

9 

/* 

Turkey -'/ 

#def i ne 

FIN 

10 

/■■-■ 

Finland '-/ 

#def i ne 

NOR 

11 

/* 

Norway '-/ 

#def i ne 

DEN 

12 

/'■•'• 

Denmark '-/ 

#def i ne 

SAU 

13 

/•'•'- 

Saudi Arabia '-/ 

#defi ne 

HOL 

14 

/- 

Holland '-'/ 


Here is the procedure which will return the address of the variable _run no 
matter what ROM you have. It only works for ROMs produced by Atari; no 
guarantees are made if you are using a version of TOS which has been modified 
in any way. 

^define SYSSASE ((OSHEADER '-'-) (0x4f2L)) 
typedef 1 ong PID : 


get_run() 

Return the address of _run (GEMDOS Process ID of current process) 
•• for any TOS version. 

890 71S kbad 

■/ 


PID '- 
get_run() 

r 

char -'savestack = (char -)Super( 
OSHEADER -osheader = -'SYSBASE; 
Super( savestack ); 

osheader = osheader-: os_beg ; 


if( osheader- ■os_version - 0x102 
if( (osheader->os_conf • 1) 

== SPA ) 

return (PID -)0x873c; 
else 

return (PID -)0x602c; 

} else { 

return (PID '-) (osheader-: p_run) 


0L ); 

/* Get the RAM OS header... -'/ 


/'-' Get the ROM OS header, because */ 
the RAM one doesn't contain a '-/ 
/* valid os_conf word with some '-/ 

/'• hard disk drivers. '-/ 

) { 

/* Low bit is pal mode: shift right'-/ 
/-'• to get country number. '-/ 

/- The location of _run in Spanish '-/ 
/-' TOS 1.0 is different from other'-/ 
/'- countries. -/ 


} 
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: hysical 


"" aS ^ 1 ne XclOS documentation Icr ;he Serserc-n c~!l -‘ales ‘h~t n f — ' 

screen ease being set will lake sheet at the'next “/BLANK fL P hys,cal 

acdress - -»**-*. ** *. DEESES 

i ne s y S tem variable screenpt has the behavior that when it is NUI t nmn- 
screen base' n0nnUl1 ' 11 Ss:s S!u,fed int0 ^ hardware as the phySl 

if you mix both scrs°nnr s nri spr <zrt — - n . 

-.'-i ‘m u ctnu jciitr to cnsnce he nhvcir 

rhey won 1 work as one might expect. When you set scr^not That l-Tno * S *' 

^uneo into the video base register every VELA NIK. S ez screen or\y se-^he 

3K -: c -i V” :he "T VBL1NK !he i si d n ;t h e e 

sSST Setscre * n " vork ** w «p«t you have 10 dear 


If you 


use either method exclusively, you won't have these problems. 


Reset Bailout Vector 


: install 

resva 1 i d 
res vector 
resmagi c 

c ssi nstal ' 


rZXZr-VZ tx ASSES' "* 

■" ' ct 0cG *>°meth.ng other than the magic number there 

mSr-I 3r ° 5ra,T,S misnt be ccun:in S on setting control curino rese- 
■ ; L '' ss,n S- o:ny program which uses resvector srould us- .“ h - ~ ’ 

tcilowing codf : a. .ouc us c something tike the 

nanGler ' ,r ' c:aG ' n 5 siting up the handcrf to other handlers 

sou 




S -26 

- 

j 3 1 4 1 i v 2 •; 


zove ' _ ! res va I i d . o r es va 1 i d 
~ove . 1 res vector , ores vector 
move. i e.ny reset , resvector 
■Hove.! eresmagi c . res valid 
rts 


save old resvalid and . 

(resvalid •night be invalid) 
set up my vector 
and val i date i t 
done with install ina 


-nyreset: gets control during a warm reset 


- reser : 


; do reset-handler stuff here 

nove.l o resvector . resvecto r 
mo ve . i 01 e s va 1 id, r e s va 1 id 
jmp (a6) 

. css 

oresvalid: ds.l 

o res vecto r : ds.l 


•• chen end with the following: 

, restore old values, including 
, resvalid (so it it was invalid, 
, it Stays invalid). Then return 

1 

1 
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Rainbow TOS Caveats 


Rainbow TOS Caveats 


Two bugs were discovered in Rainbow TOS after its release. Both of these bugs are 
corrected by T0S14FIX . PRC, an \AUTO\ folder patch program available from Atari. The buqs 
are described in detail below. 


rsconf J. - rsconf O , the XBIOS call that sets the configuration of the RS232 port does not 

work correctly regarding flow control. Three kinds of flow control are supported 
by i OS: RTS/CTS. XON/XOFF, and no How control. RTS/CTS flow control 
cicn't work in the original ROM TOS. but was iixed in Mega TOS. In Rainbow 
TOS. the ability to return the current baud rate was added to the rsconf () call 
but at the same time, it lost the ability to set RTS/CTS How control. Any attempt’ 

10 set RTS/CTS flow control instead sets NO How control. 


If the filename you pass to shel_find() is followed in memory by a backslash 
or a colon, shel _f i nd () will search lor a nuil-string lilename. This could result 
in apparently random inability of the AES to llnd a lilename you pass it for 
She !_n nd ( ) - it all depends on what is AFTER the string in memory. The 
rsrc_ i oad() call could be allecteo by this bug as well, since it uses 
See i _ri nd () to get the lull pathname oi a resource file. 
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